home *** CD-ROM | disk | FTP | other *** search
/ eudora.co.nz / www.eudora.co.nz.tar / www.eudora.co.nz / EIMSTAPGateway.sit / TAPGateway readme < prev    next >
Text File  |  2001-02-01  |  3KB  |  66 lines
  1. EIMS TAP Gateway
  2. Written by Glenn Anderson
  3. Copyright 2001 QUALCOMM, Inc.
  4.  
  5. Requirements
  6.  
  7. EIMS 2 or later (EIMS 1.x will not work)
  8. A suitable modem and access to a TAP paging terminal
  9.  
  10. Why use TAP?
  11.  
  12. Telocator Alphanumeric Protocol (TAP) is a protocol for sending messages to phones and pagers over a modem. Most telephone companies already offer an Internet email gateway to their paging and messaging services. However TAP is a useful alternative because it does not require Internet access, so it can be used to send a message to your phone or pager when your Internet connection goes down. Sending messages using TAP may also be cheaper that using an email gateway.
  13.  
  14. How it works
  15.  
  16. The TAP gateway takes messages from EIMS in the Save as Files format and sends them over a connection, usually a modem, to a TAP terminal. The TAP gateway takes the envelope sender, the subject header, and the body of the message to make the short message to be sent.
  17.  
  18. Setting up
  19.  
  20. Preferences
  21.  
  22. If necessary, a password for the TAP terminal and a maximum message length can be specified here.
  23.  
  24. Connection Settings
  25.  
  26. Under the file menu, go to Connection Settings. The TAP gateway uses the Communications Toolbox to connect, typically the Apple Modem Tool should be used. The TAP standard requires XON/XOFF flow control, 7 data bits, even parity, 1 stop bit. Your telephone company should have details as to what they require. I recommend setting Error Correction to Optional and Correction Type to Hardware.
  27.  
  28. Configuring EIMS
  29.  
  30. For the TAP gateway to work, messages need to be delivered to it's Incoming Mail folder with addresses in the format <number>@domain. The @domain part will be stripped off and the <number> used to send the message. The easiest way of doing this is to add a domain for the TAP gateway in Mail Routing, set it to Route Via: Save as Files, and enter the full path to the Incoming Mail folder for the TAP gateway. The domain entered does not have to exist in the DNS. You can then create accounts in a real domain and set them to forward to 1234@tap-domain.company.com where 1234 is the number for the message to be sent to, and tap-domain.company.com is the domain in the Mail Routing.
  31.  
  32. Example
  33.  
  34. Here is an example of what the console in the TAP gateway will show when everything works.
  35.  
  36. processing file b69e2577
  37. phone number: 5300123456
  38. message: From: glenn@qualcomm.co.nz Subject: PPC TAP gateway test 3 This is a test message. 
  39. Connection opening
  40. Connection open
  41. Waiting for ID=
  42. ID= matched
  43. Sending login
  44. <ACK> received
  45. Waiting for go ahead
  46. <ESC>[p received
  47. Sending message
  48. <ACK> received
  49. Logging out
  50. AT YOUR REQUEST
  51. <ESC><EOT> received
  52. Connection closing
  53. Connection closed
  54.  
  55. What isn't implemented yet
  56.  
  57. Queuing and error handling is not implemented yet. The TAP gateway will only try once to send a message, and the message will not be bounced if it fails. You may want to set the Apple Modem Tool to redial if you are having problems with the modem not connecting.
  58.  
  59. Multipart MIME messages are not handled correctly yet, results may be unexpected if multipart MIME messages such as HTML formatted messages are sent to the TAP gateway. Rather than getting useful text, you will probably get MIME stuff.
  60.  
  61. The maximum limit on messages is 248 characters minus the length of the phone number.
  62.  
  63. Bug reports
  64.  
  65. Send bug reports and suggestions to tap@qualcomm.co.nz
  66.